package cn.iocoder.yudao.module.eval.service.assignment;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.eval.controller.admin.assignment.vo.EvalPersonnelAssignmentPageReqVO;
import cn.iocoder.yudao.module.eval.dal.dataobject.assignment.EvalPersonnelAssignmentDO;

import javax.validation.Valid;
import java.util.List;

/**
 * 人员分配 Service 接口
 *
 * @author 芋道源码
 */
public interface EvalPersonnelAssignmentService {

    /**
     * 创建人员分配
     *
     * @param planId 计划ID
     * @param userId 用户ID
     * @param personType 人员类型
     * @param subjectId 科目ID
     * @return 分配ID
     */
    Long createAssignment(Long planId, Long userId, Integer personType, Long subjectId);

    /**
     * 更新人员分配
     *
     * @param id 编号
     * @param assignmentStatus 分配状态
     */
    void updateAssignment(Long id, Integer assignmentStatus);

    /**
     * 删除人员分配
     *
     * @param id 编号
     */
    void deleteAssignment(Long id);

    /**
     * 获得人员分配
     *
     * @param id 编号
     * @return 人员分配
     */
    EvalPersonnelAssignmentDO getAssignment(Long id);

    /**
     * 获得人员分配分页
     *
     * @param pageReqVO 分页查询
     * @return 人员分配分页
     */
    PageResult<EvalPersonnelAssignmentDO> getAssignmentPage(@Valid EvalPersonnelAssignmentPageReqVO pageReqVO);

    /**
     * 获得计划的人员分配列表
     *
     * @param planId 计划ID
     * @return 人员分配列表
     */
    List<EvalPersonnelAssignmentDO> getAssignmentsByPlan(Long planId);

    /**
     * 自动分配人员
     *
     * @param planId 计划ID
     * @return 分配结果
     */
    Boolean autoAssignPersonnel(Long planId);

} 